home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Scope / Scope Disk #078 (199x)(Scope PD)(US)[WB].zip / Scope Disk #078 (199x)(Scope PD)(US)[WB].adf / RxSlides / RxSlides.DOC < prev    next >
Text File  |  1989-06-30  |  6KB  |  154 lines
  1.                 RxSlides
  2.  
  3.         An IFF picture server controlled through ARexx
  4.  
  5.     RxSlides is a background (load-and-stay-resident) program which can pop
  6. up a picture upon command.  It will also make a transition from one picture
  7. to another, and has several types of transition.
  8.  
  9.     RxSlides is based on a program called "Dissolve" that I found on
  10. Amicus 15.  The author of that program, Lee M. Robertson, ( PLINK: lmr )
  11. wrote in his DOC file, "If someone was real ambitious they could do a
  12. program like Dpslide that did a lot of different displays with a display
  13. list."  I guess I was "real ambitious", because that's one of the things
  14. you can do with RxSlides.  Because the commands to this program can be
  15. written by an ARexx program, however, you can do much more powerful things
  16. than just write a display list.  For instance, you should be able to write
  17. a program that will read the directory of a disk and display all the
  18. pictures on it (assuming that you set up a filename convention to tell
  19. which are pictures).
  20.  
  21.     RxSlides has worked fine for me with 320 by 200 pictures.  I can't
  22. guarantee that bigger pictures will work, nor HAM pictures, but I don't
  23. know for sure.  It doesn't do well changing from one resolution to another --
  24. the best I can say is that it stayed up when I asked for a bigger picture,
  25. then showed the next 320 by 200 one squished onto the top half of the
  26. screen!
  27.  
  28.     Lee R. wrote that [dissolving one picture into another].."requires that the
  29. new picture has the same attributes (size, colors, ham, etc.) as the current
  30. picture, because you can't change the screen attributes between the pictures."
  31. What I tried to do was close the screen and open a new one if the attributes
  32. didn't match; but I wasn't 100% successful.  I partially got around the
  33. problem of colors by interpolating the color maps from the old picture into
  34. the new one.  This can give some pretty peculiar effects, so I suggest that
  35. if you are developing a set of pictures yourself, you keep the palettes as
  36. similar as possible between pictures.  The color interpolation seems the
  37. least disturbing with the "dissolve" transition (and the "zap" transition,
  38. which hardly counts).
  39.  
  40.     Unless you are running ARexx, RxSlides won't do a thing for you except
  41. chew up some of your memory.  If you have ARexx, create a rexx program file
  42. something like this (say its name is CPix.rexx):
  43.  
  44. /* Charley slideshow */
  45. address SLIDES
  46. 'trans 0'
  47. 'show df1:cluck'
  48. 'wait 25'
  49. 'trans 6'
  50. 'show df1:robots'
  51. 'wait 25'
  52. 'show df1:ghost4'
  53. 'wait 50'
  54. 'exit'
  55.  
  56. This is assuming that you have 320 x 200 IFF picture files called
  57. "cluck", "robots", and "ghost4" on your df1: disk.  Then do, from CLI
  58. or Wshell,
  59.  
  60. >rexxmast
  61. >RxSlides
  62.  
  63. then from Wshell
  64. >CPix (or whatever your rexx program is)
  65.  
  66. or from CLI
  67. >rx CPix
  68.  
  69. You should see the first picture appear on the screen, then dissolve
  70. into the second, then dissolve into the third; then after another second
  71. you will be back to the CLI screen.
  72.  
  73. Note that the Rexx address of this program is SLIDES.  If you run two
  74. copies of this at once, the address of the second is SLIDESA.  If you
  75. run a third, the address of the third should be SLIDESB, and so on to
  76. SLIDESZ, but I haven't tried more than two.
  77.  
  78. Commands accepted:
  79.  
  80.   show <filename>    display the IFF picture in <filename>
  81.  
  82.   speed <integer>    controls the number of picture bits set
  83.               between successive "blit"s; 1280 is the
  84.               default.
  85.  
  86.   wait <integer>    wait that number of 1/50-th's of a second
  87.               before accepting another command.  This
  88.               lets you control the speed of the slideshow.
  89.  
  90.   failat <integer>    gives you some control of how serious a problem
  91.               will cause the program to exit.  Default is
  92.               21, which asks the program to try its best
  93.               not to exit until you ask it to.  I recommend
  94.               that you leave this parameter alone.
  95.  
  96.   index <integer>    I think that this controls which of several
  97.               pseudo-random bit patterns is used for the
  98.               "dissolve" transition.  No guarantees if you
  99.               try a number bigger than 15 here!  I'm not
  100.               really sure what it does, and I recommend
  101.               that you leave this parameter alone.
  102.  
  103.   trans <integer>    Controls the type of transition between pictures.
  104.               I took LMR's suggestions about some types of
  105.               effects and have implemented the following:
  106.     trans 0        "zap" instantly pop up the new picture all at once.
  107.     trans 1        "twipe" wipe the new picture from top to bottom
  108.     trans 2        "bwipe" wipe the new picture from bottom to top
  109.     trans 3        "lwipe" wipe the new picture from left to right
  110.     trans 4        "rwipe" wipe the new picture from right to left
  111.     trans 5        "vblind" venetian blinds transition -- new picture
  112.               appears as lots of vertical lines that get wider
  113.               and wider.  Try it, but I won't say "try it, you'll
  114.               like it".
  115.     trans 6        "dissolve" the good old original, and I think the
  116.               best for widely differing palettes.
  117.  
  118.   front            pops the picture screen to the front.  Useful only
  119.               after --
  120.  
  121.   back            pushes the picture screen to the back.  You could
  122.               do this before Rexx wants to write some output,
  123.               and then do a "front"; or maybe have two copies
  124.               of RxSlides running, and flip-flop between the
  125.               two pictures.
  126.  
  127.   close            close the picture window and screen, but leave
  128.               RxSlides running.  That way you don't have to
  129.               get RxSlides off the disk again to run it, but
  130.               of course it is taking up memory.
  131.  
  132.   exit            stop the RxSlides background process
  133.   quit            ditto
  134.  
  135. I'll now leave it up to your imagination to do something with this.  I hope
  136. to add more transition types and command syntax to use the names for the
  137. transitions, not just the code numbers.  I should also supply a stand-alone
  138. program that sends a "quit" message to RxSlides, so that you can kill the
  139. process without having Rexx running. Also, I want to do better with more
  140. picture sizes, and to do a little more tidying up of the source coding.  I'll
  141. be happy to share the source sometime soon.  Please write via US Mail with
  142. bug reports, news of applications using this, or suggested enhancements.
  143. Of course I wouldn't mind some shareware contributions, but since much of
  144. this was Lee Robertson's work I won't make a big pitch.  Hey -- somebody
  145. who's on PLINK, leave some mail for him to tell him what happened to his
  146. program!
  147.  
  148.     Good Luck,
  149.     Dean Bandes
  150.     225 Cypress Street
  151.     Newton Centre, MA 02159
  152.     (617) 965-1268
  153.     
  154.